home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 051-075 / disk_064 / readmes / aboutthisrelease next >
Text File  |  1992-05-06  |  9KB  |  234 lines
  1.  
  2. ABOUT THIS RELEASE - 03/25/87  CBM
  3. ==================================
  4.  
  5. "IFF" - Interchange File Format
  6.  
  7. The files contained on this disk are the text and sample code for producing
  8. and using the Interface File Format developed jointly by Electronic Arts and
  9. Commodore-Amiga, Inc.  
  10.  
  11. We at Commodore-Amiga have adopted this standard for internal use and we
  12. encourage our developers to do so as well.  The standard allows programs
  13. developed independently to easily share data with one another.  
  14.  
  15. Electronic Arts has placed all of this sample code into the public domain
  16. to encourage others to adopt the standard and to use it.
  17.  
  18.  
  19. NOTE:  The document "ea.iff.85" outlines the format of the data
  20.        chunks.  If there is a chunk with a name that is private to a
  21.        particular application, it may be ignored by another application
  22.        trying to read and use the file.  Thus only recognized chunks
  23.        can be loaded and utilized.
  24.  
  25.        In order to avoid duplication in the naming of private chunks,
  26.        Commodore will act as a clearing house for private chunk names.
  27.        If you wish, you can either register the chunk name alone, or provide
  28.        us with a description of the contents of the chunk along with the
  29.        name.  By this means, we may be able to extend the standard in a
  30.        logical fashion, making it possible for future programs to maintain
  31.        compatibility.   
  32.  
  33.        A list of new reserved FORM and Chunk names can be found on this
  34.        disk in DOCS/addenda/ReservedNames.  These new FORMs are being
  35.        designed by independent developers and in some cases are being
  36.        developed cooperatively in our amiga.dev/iff conference on BIX.
  37.        When I receive final specs on any of the new forms, I will
  38.        post the specs in amiga.dev/iff, and they will be included
  39.        in the next release of this disk.
  40.  
  41.        If possible, please discuss any new chunk or form ideas with
  42.        other developers and with us before registering them.
  43.        Our BIX amiga.dev/iff conference has been set up for this
  44.        purpose, but any group discussion will be helpful.
  45.        We want to create new standards, not just new chunks and forms.
  46.  
  47.        To register a new chunk or form, send a letter with whatever
  48.        detail you wish to release, and your name/address/phone# to:
  49.  
  50.           Carolyn Scheppner
  51.           Software Tech Support
  52.           CBM
  53.           1200 Wilson Drive
  54.           West Chester, PA.  19380
  55.  
  56.  
  57. Here is a list of the files on this disk:
  58.  
  59. 1. Executable EA examples
  60.  
  61.      EXECUTABLE (dir)
  62.        IFFCheck                         ILBM2Raw
  63.        ILBMDump                         Raw2ILBM
  64.        Read8SVX                         
  65.  
  66. 2. The EA IFF docs, Addenda on new forms, chunks, reserved names
  67.  
  68.      DOCS (dir)
  69.           addenda (dir)
  70.             WORD                             HEAD
  71.             ACBM                             CCRT.errata
  72.             DPPV                             ReservedNames
  73.             SMUS.SEvents                     
  74.        8svx                             ea.iff.85
  75.        ftxt                             ilbm
  76.        smus                             
  77.  
  78. 3. Batch files (not utilized for native compilation)
  79.  
  80.      bat.files (dir)
  81.        batch.files.joined               
  82.  
  83. 4. Native linkage information for the EA examples
  84.  
  85.      lnk.files (dir)
  86.        ilbm2raw.lnk                     ilbmdump.lnk
  87.        other.lnks                       raw2ilbm.lnk
  88.        read8svx.lnk                     README
  89.        showilbm.lnk                     
  90.  
  91. 5. General info about this disk and using the IFF code
  92.  
  93.      READMES (dir)
  94.        AboutThisRelease                 backgrnd.doc
  95.        CompilingIFF                     readme.doc
  96.  
  97. 6. C source files of IFF modules and EA examples
  98.  
  99.      SOURCE (dir)
  100.        bmprintc.c                       dunpack.c
  101.        gio.c                            giocall.(sample)
  102.        IFFCheck.c                       iffr.c
  103.        iffw.c                           ILBM2Raw.c
  104.        ILBMDump.c                       ilbmr.c
  105.        ilbmw.c                          packer.c
  106.        putpict.c                        Raw2ILBM.c
  107.        Read8SVX.c                       README
  108.        readpict.c                       remalloc.c
  109.        ShowILBM.c                       unpacker.c
  110.  
  111. 7. The IFF include files (add the iff directory to YOUR include directory)
  112.  
  113.      INCLUDE (dir)
  114.           iff (dir)
  115.             8SVX.h                           compiler.h
  116.             gio.h                            iff.h
  117.             ilbm.h                           intuall.h
  118.             packer.h                         putpict.h
  119.             readpict.h                       remalloc.h
  120.             SMUS.h                           
  121.  
  122. 8. Zapicon (brush to icon) and other assorted files
  123.  
  124.      other.files (dir)
  125.        bird3to8.lo3                     dragon.c
  126.        startup.txt                      zapicon
  127.  
  128. 9. Lattice object code IFF modules (compiled with -v on LC2)
  129.  
  130.      OBJECT (dir)
  131.        bmprintc.o                       dunpack.o
  132.        gio.o                            iffr.o
  133.        iffw.o                           ilbmr.o
  134.        ilbmw.o                          packer.o
  135.        putpict.o                        readpict.o
  136.        remalloc.o                       unpacker.o
  137.  
  138. 10. Other IFF example source/object/executable
  139.  
  140.      EXAMPLES (dir)
  141.           Display (dir)
  142.             Display.c                        Display.with
  143.             iffmsgs.c                        iffmsgs.o
  144.             myreadpict.c                     myreadpict.h
  145.             myreadpict.o                     
  146.        Astartup.obj                     cycvb.c
  147.        Old2ILBM                         Old2ILBM.c
  148.        Old2ILBM.with                    ScreenSave
  149.        ScreenSave.c                     ScreenSave.with
  150.        Uncycle                          Uncycle.c
  151.  
  152. 11. [root] Viewers (ShowILBM, Display) and ILBMs including doc illustrations
  153.  
  154.   .info                            8SVX.pic
  155.   8SVX.pic.info                    bird0to2
  156.   bird0to2.info                    Cycles
  157.   Cycles.info                      Disk.info
  158.   Display                          Display.info
  159.   dragon                           dragon.info
  160.   FTXT.pic                         FTXT.pic.info
  161.   ShowILBM                         ShowILBM.info
  162.   SMUS.pic                         SMUS.pic.info
  163.  
  164.  
  165.  
  166. DESCRIPTION OF THE EXAMPLES ON THIS DISK:
  167.  
  168. (In EXECUTABLE directory - C source in SOURCE dir)
  169.  
  170.        IFFCheck - Prints out the structure of an IFF file
  171.        ILBM2Raw - Converts an ILBM to raw bitmap, colormap
  172.        ILBMDump - Prints out ASCII representation of ILBM file
  173.        Raw2ILBM - Converts raw bitmap file to ILBM
  174.        Read8SVX - Reads an 8SVX sound sample and prints contents                        
  175.  
  176.  
  177. (In other.files directory - source not available)
  178.  
  179.        Zapicon - Converts a DPaint brush to an icon
  180.  
  181.  
  182. (In EXAMPLES directory - C source in EXAMPLES directory)
  183.  
  184.        ScreenSave --- Save front screen as ILBM
  185.                       (works with HAM, creates an icon for ILBM)
  186.        Old2ILBM ----- Convert old IG format files to ILBM
  187.        Uncycle ------ Deactivate cycling chunks of a DPaint ILBM
  188.                       This can also be accomplished by re-saving the
  189.                       pic from DPaint after setting all cycle range
  190.                       speeds to lowest position.
  191.        Astartup.obj - 1.2 Amiga startup code required when linking
  192.                       some of my examples (cas)
  193.        cycvb.c ------ Dan Silva's DPaint cycling interrupt code
  194.  
  195.  
  196. (In root directory - C source in SOURCE and EXAMPLES)
  197.  
  198.        ShowILBM ----- This ILBM viewer from EA displays one or more
  199.                       ILBMs in a ViewPort for 5 seconds each.
  200.  
  201.                       CLI Usage: Showilbm picfile1 [ picfile2 ...]
  202.                       WB Usage:  Click on ShowILBM, hold shift and
  203.                                  click on pic icons, double-clicking
  204.                                  on last selection
  205.  
  206.        Display ------ This ILBM viewer displays a single ILBM in a
  207.                       screen/window until the invisible close gadget
  208.                       in the upper left corner is clicked.  
  209.  
  210.                       An optional time delay (in seconds) can be
  211.                       specified as the 2nd command line argument.
  212.                       This will cause the the display to terminate
  213.                       automatically after the specified time interval.
  214.  
  215.                       It handles normal and HAM ILBMs, and it
  216.                       automatically cycles any ILBM with active
  217.                       cycling chunks.
  218.  
  219.                       The TAB key toggles cycling, left mouse click
  220.                       toggles the screen drag bar.  Click in upper
  221.                       left to close when the screen bar is hidden.
  222.  
  223.                       CLI Usage:  Display picfile [time]
  224.                       WB Usage:   Click on Display, hold shift and
  225.                                   double-click on pic.
  226.  
  227.                       NOTE: to deactivate the cycling chunks in a
  228.                       DPaint pic, either use the Uncycle utility on
  229.                       this disk, or resave the pic from DPaint after
  230.                       setting the speed for each cycle range to its
  231.                       lowest position.
  232.  
  233.  
  234.